<html><head>

<meta http-equiv="CACHE-CONTROL" content="NO-CACHE">
 <link rel="SHORTCUT ICON" href="http://labelme.csail.mit.edu/Icons/favicon16.ico">
 <meta name="KEYWORDS" content="LabelMe, open annotation tool, images, database, matlab, object">

<script>
<!--#include virtual="./js/my_scripts.js" -->
</script>

<style type="text/css">
body {font-family:Arial; background-color:white; color:black;
margin-top:5px; margin-left:8px; margin-right:8px; margin-bottom: 0px;}

.top-shadow {top:1em;}
.main-section {position:relative; bottom:2px; right:2px;
padding:0.25em; background-color:#ffffff; border:1px solid white;}

.image-section {position:relative; width:32.5em;}
.main-link:link,
.main-link:visited,
.main-link:hover {color:#000000; text-decoration:none;}
.LabelMeNEWtight198x55 {width: 10.2em; height: 2.9em; border: 2px solid white;}
.MIT {position:absolute; top:5.2em; left:3.8em; width:4em; height:2em;
border:0px solid white;}
.labelingCar {position:absolute; top:11.38em; left:1.8em; width:13em;
height:7em; border:0px solid white;}
.title {position:absolute; top:3.3em; left:.3em;}

.bottom-shadow {top:1.5em;}
.textbox {position:relative; bottom:2px; right:2px; padding:0.25em;
background-color:#ffffff; border:1px solid gray; FONT-SIZE:12px;font-family:Arial; }

.top-shadow,
.bottom-shadow {position:relative; left:0em; margin-left:2px;
margin-top:2px; width:800px; background-color: #ffffff;
border:1px solid white;}

</style><title>LabelMe: The open annotation tool</title></head><body>

<script type="text/javascript">
WriteLogMsg('*Download_page');
</script>

<!-- Start of top section -->
<div class="top-shadow">
<div class="main-section">

<table style="vertical-align: top; width: 100%;" border="0" cellpadding="0" cellspacing="0">
<tbody><tr>
<td style="vertical-align: top;">
<!-- Start of left panel -->
<font size="-1">
  <table style="vertical-align: top;" border="0" cellpadding="0" cellspacing="4">
    <tbody><tr>
      <td>
            <a href="http://labelme.csail.mit.edu/index.html">
<img class="LabelMeNEWtight198x55" src="Icons/LabelMeNEWtight198x55.gif" alt="" title=""></a><br>
      <b><font point-size="8">The open image labeling tool</font></b><br><br>
      </td>
    </tr>
    <tr>
      <td>
        <a href="http://labelme.csail.mit.edu/tool.html">Labeling tool</a>
      </td>
    </tr>
    <tr>
      <td>
        <a href="http://labelme.csail.mit.edu/browseLabelMe/index.html">Thumbnails</a>
      </td>
    </tr>
    <tr>
      <td>
        <a href="http://labelme.csail.mit.edu/LabelMeToolbox/index.html">Matlab Toolbox</a>
      </td>
    </tr>
    <tr>
      <td>
        <a href="http://labelme.csail.mit.edu/upload.html">Upload Images</a>
      </td>
    </tr>
    <tr>
      <td>
<br>
        <a href="http://labelme.csail.mit.edu/AboutMe.html">Credits</a>
      </td>
    </tr>
    <tr><td></td></tr>
    <tr><td></td></tr>
    <tr>
      <td>
      </td>
    </tr>


  </tbody></table>
</font>
<!-- End of left panel -->
</td>

<td style="vertical-align: top;" align="left">


<div class="textbox">
<div>
<h1>
<p><font color="#ff0000"><a name="first">Have you labeled a few objects?</a></font></p>
</h1>

<p>Before downloading the dataset, we ask that you label some
images using the <a href="http://labelme.csail.mit.edu/tool.html">online annotation tool</a>. It
only takes a few minutes to label several objects.  In return, you will
receive thousands of annotated images.  Also, the new annotations that
you just provided will be immediately included in the downloaded
dataset.<br><br></p>
</div>
</div>

<br>

<!-- Start of description section-->
<div class="textbox">

<p><a href="http://labelme.csail.mit.edu/index.html">LabelMe</a> is a web-based image annotation
tool that allows researchers to label images and share the annotations
with the rest of the community. If you use the database, we only ask
that you contribute to it, from time to time, by using the labeling
tool.</p>

<h2>
<p><a name="documentation">Documentation</a></p>
</h2>

<p>
B. C. Russell, A. Torralba, K. P. Murphy, W. T. Freeman, <i>LabelMe: a database and web-based tool for image annotation</i>. International Journal of Computer Vision, pages 157-173, Volume 77, Numbers 1-3, May, 2008.
(<a href="http://people.csail.mit.edu/brussell/research/AIM-2005-025-new.pdf">PDF</a>)</p>

<!--
<p>B. C. Russell, A. Torralba, K. P. Murphy, W. T. Freeman, <i>LabelMe: a
database and web-based tool for image annotation</i>. MIT AI Lab Memo
AIM-2005-025, September, 2005. (<a href="http://people.csail.mit.edu/brussell/research/AIM-2005-025-new.pdf">PDF</a>)</p>
-->

<h2>
<p><a name="download">Downloads</a></p>
</h2>

<p>There are two ways to work with the dataset: (1) downloading all the images
via the LabelMe Matlab toolbox. The toolbox will allow you to customize the portion
of the database that you want to download, (2) Using the images online via the LabelMe Matlab
toolbox. This option is less preferred as it will be slower, but it will allow you to explore the dataset before downloading it.</p>

<p>Once you have installed the database, you can use the <a href="http://labelme.csail.mit.edu/LabelMeToolbox/index.html">LabelMe
Matlab toolbox</a> to read the annotation files and query the images to
extract specific objects.</p>

<div style="background-color: rgb(255, 221, 221);">
<h2>
<p><a name="download">Option 1: Customizable download using the LabelMe Matlab toolbox</a></p>
</h2>

<p>Before downloading the dataset, we only ask you to label some images using the <a href="http://labelme.csail.mit.edu/tool.html">annotation tool online</a>. Any new labels that you will add, will be inmediately ready for download.</p>

<p><b>Step 1</b></p>

<p>Download the <a href="http://labelme.csail.mit.edu/LabelMeToolbox/LabelMeToolbox.zip">
LabelMe Matlab toolbox</a> and add the toolbox to the Matlab path.
</p>

<p><b>Step 2</b></p>

<p>The function <a href="http://labelme.csail.mit.edu/LabelMeToolbox/LMinstall.m">LMinstall</a>
will download the database. There are three ways to use this function:</p>

<p>
</p><li>To download the entire dataset, type the following into Matlab:
<p></p>

<p>
<font color="#006600">
HOMEIMAGES = '/desired/path/to/Images';<br>
HOMEANNOTATIONS = '/desired/path/to/Annotations';<br>
LMinstall (HOMEIMAGES, HOMEANNOTATIONS);<br>
</font>
</p>

<p>where "/desired/path/to/" is the desired location where the
annotations and images will be stored.  This process will create the
following directory structure under "/desired/path/to/":
</p>

<p>
<code>
./Annotations<br>
./Annotations/folder1<br>
...<br>
./Annotations/folderN<br>
<br>
./Images<br>
./Images/folder1<br>
...<br>
./Images/folderN<br>
</code>
</p>

<p>where <code>folder1</code> through <code>folderN</code> are
directories containing the images and annotations.</p>

<p>
</p></li><li>If you only want to download a list of specific folders, then run:
<p></p>
<p>
<font color="#006600">
HOMEIMAGES = '/desired/path/to/Images';<br>
HOMEANNOTATIONS = '/desired/path/to/Annotations';<br>
folderlist = {'05june05_static_street_porter'};<br>
LMinstall (folderlist, HOMEIMAGES, HOMEANNOTATIONS);<br>
</font>
</p>
<p>
This will download only one folder from the collection.
You can see the complete list of folders <a href="http://labelme.csail.mit.edu/browseLabelMe/index.html">here</a>.
</p>

<p>
</p></li><li>If you already have the dataset but want to update the
annotations, then use LMinstall with four arguments:<p></p>

<p>
<font color="#006600">
LMinstall (folders, images, HOMEIMAGES, HOMEANNOTATIONS);
</font>
</p>

<br>

</li></div>

<br>
<div style="background-color: rgb(221, 221, 255);">

<br>

<h2>
<p><a name="download">Option 2: Access the online database directly
with the LabelMe Matlab toolbox</a></p>
</h2>

<p>Before downloading the dataset, we only ask you to label some images using the <a href="http://labelme.csail.mit.edu/tool.html">annotation tool online</a>. Any new labels that you will add, will be inmediately ready for download.</p>

<p>If you use the <a href="http://labelme.csail.mit.edu/LabelMeToolbox/index.html">LabelMe
Matlab toolbox</a>, it is not necesary to download the database. You
can use the online images and annotations in the same way as if they
were on your local hard drive. This might be slow, but it will let you
explore the database before downloading it. If you
plan to use the database extensively, it is better to download a local
copy for yourself.</p>

<p>Here are a few Matlab commands that show how to use the online database:</p>

<font color="#006600">
HOMEIMAGES = 'http://people.csail.mit.edu/brussell/research/LabelMe/Images';<br>
HOMEANNOTATIONS = 'http://people.csail.mit.edu/brussell/research/LabelMe/Annotations';<br>
<br>
D = LMdatabase(HOMEANNOTATIONS); % This will build an index, which will take few minutes. <br>
<br>
% Now you can visualize the images<br>
LMplot(D, 1, HOMEIMAGES);<br><br>
% Or read an image<br>
[annotation, img] = LMread(D, 1, HOMEIMAGES);<br>
</font>
<p>
You can query the database to select the images you want and install
only those ones. For instance, if you are interested only in images
containing cars, you can run the following:
</p>
<p>
<font color="#006600">
% First create the list of images that you want:<br>
[Q,j] = LMquery(D, 'object.name', 'car');<br>
clear folderlist filelist<br>
for i = 1:length(Q);<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; folderlist{i} = Q(i).annotation.folder;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; filelist{i} = Q(i).annotation.filename;<br>
end<br><br>
% Install the selected images:<br>
HOMEIMAGES = '/desired/path/to/Images';<br>
HOMEANNOTATIONS = '/desired/path/to/Annotations';<br>
LMinstall (folderlist, filelist, HOMEIMAGES, HOMEANNOTATIONS);<br>
</font>
</p>

<br>








</div>


<!-- End of description section -->
</td></tr>
</tbody></table>

</div>
</div>
<!-- End of top section -->

<!-- Start of counter -->
<div style="position: relative; top: 2em; left: 1.1em; width: 26em; height: 3em;">
<div style="position: absolute; right: 0em; top: 0.2em;">
<!--WEBBOT bot="HTMLMarkup" startspan ALT="Site Meter" -->
<script type="text/javascript" language="JavaScript">var site="s21labelme"</script>
<script type="text/javascript" language="JavaScript1.2" src="http://s21.sitemeter.com/js/counter.js?site=s21labelme"></script>
<noscript>
<p><a href="http://s21.sitemeter.com/stats.asp?site=s21labelme" target="_top">
<img src="http://s21.sitemeter.com/meter.asp?site=s21labelme" alt="Site Meter" border="0"/></a>
</p></noscript>
<!-- Copyright (c)2005 Site Meter -->
<!--WEBBOT bot="HTMLMarkup" Endspan -->
</div>
</div>
<!-- End of counter -->





</body></html>
